home *** CD-ROM | disk | FTP | other *** search
/ Windows Game Programming for Dummies (2nd Edition) / WinGamProgFD.iso / mac / DirectX SDK / DXSDK / samples / Multimedia / VBSamples / DirectMusic / DLSEffects / readme.txt < prev    next >
Text File  |  2001-10-10  |  2KB  |  50 lines
  1. //-----------------------------------------------------------------------------
  2. // 
  3. // Sample Name: DLS Effects Sample
  4. // 
  5. // Copyright (C) 1999-2001 Microsoft Corporation. All rights reserved.
  6. // 
  7. //-----------------------------------------------------------------------------
  8.  
  9.  
  10. Description
  11. ===========
  12. This application demonstrates the use of Downloadable Sounds for sound
  13. effects, and how to send MIDI notes.
  14.  
  15. The DLS instruments are taken from Boids.dls. That collection actually
  16. contains only a single instrument, called Vocals. However, the instrument
  17. is based on different wave samples for different "regions" or ranges
  18. of notes. For example, the first speech sound is used when any note
  19. between C3 and B3 is sent. The speech sounds are played at the correct
  20. pitch only when the note is the lowest one in the region.
  21.  
  22. One of the samples, called Heartbeat, is valid for the range B7-B8.
  23. Because this is not a vocal sample, we can reasonably vary the pitch
  24. by playing various notes within that range, as determined by the
  25. slider setting.
  26.  
  27. Heartbeat is also the only sample in the DLS collection that is based
  28. on a looped wave. Hence it can be played continuously for up to the
  29. maximum duration of a note. The other samples will play only once
  30. regardless of the duration of the note sent.
  31.   
  32. Path
  33. ====
  34.   Source: DXSDK\Samples\Multimedia\VBSamples\DirectMusic\DLSEffects
  35.  
  36.   Executable: DXSDK\Samples\Multimedia\VBSamples\DirectMusic\bin
  37.  
  38.  
  39. User's Guide
  40. ============
  41. Clicking any of the 'Notes' will play the associated vocal.  You may also turn 
  42. Heartbeat on or off, and change the pitch, or velocity of notes.
  43.  
  44. Programming Notes
  45. =================
  46.    This sample shows how to control notes in a DLS using SendNotePMsg, and SendMidiPmsg.
  47.    Whenever a note is clicked, we will call SendNotePMsg to turn the note on, for a specific
  48.    duration (which varies for each note).  When we want to turn the Heartbeat on we will call
  49.    SendMidiPMsg, and then call SendNotePMsg once more to turn the Heartbeat off.
  50.